<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>nrf51/Source/ext_sensors/synaptics_touchpad/synaptics_touchpad.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css" />
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="alias.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="alias.js"></script>

<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>


<script type="text/javascript">
  jQuery(document).ready(function () {
    if(gref){ // Number all _img and _table classes
      gref();
    }
  });
</script>

</head>
<body>
<div id="top"><!-- do not remove this div! -->

<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">nRF51 General Code Examples
   
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.7.5 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
  initNavTree('synaptics__touchpad_8c.html','');
</script>
<div id="doc-content">
<div class="header">
  <div class="headertitle">
<div class="title">nrf51/Source/ext_sensors/synaptics_touchpad/synaptics_touchpad.c</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* Copyright (c) 2009 Nordic Semiconductor. All Rights Reserved.</span>
<a name="l00002"></a>00002 <span class="comment"> *</span>
<a name="l00003"></a>00003 <span class="comment"> * The information contained herein is confidential property of Nordic</span>
<a name="l00004"></a>00004 <span class="comment"> * Semiconductor ASA.Terms and conditions of usage are described in detail</span>
<a name="l00005"></a>00005 <span class="comment"> * in NORDIC SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT.</span>
<a name="l00006"></a>00006 <span class="comment"> *</span>
<a name="l00007"></a>00007 <span class="comment"> * Licensees are granted free, non-transferable use of the information. NO</span>
<a name="l00008"></a>00008 <span class="comment"> * WARRANTY of ANY KIND is provided. This heading must NOT be removed from</span>
<a name="l00009"></a>00009 <span class="comment"> * the file.</span>
<a name="l00010"></a>00010 <span class="comment"> *</span>
<a name="l00011"></a>00011 <span class="comment"> */</span>
<a name="l00012"></a>00012 
<a name="l00013"></a>00013 <span class="preprocessor">#include &lt;stdbool.h&gt;</span>
<a name="l00014"></a>00014 <span class="preprocessor">#include &lt;stdint.h&gt;</span>
<a name="l00015"></a>00015 
<a name="l00016"></a>00016 <span class="preprocessor">#include &quot;<a class="code" href="twi__master_8h.html" title="Software controlled TWI Master driver.">twi_master.h</a>&quot;</span>
<a name="l00017"></a>00017 <span class="preprocessor">#include &quot;<a class="code" href="synaptics__touchpad_8h.html" title="Synaptics Touchpad driver.">synaptics_touchpad.h</a>&quot;</span>
<a name="l00018"></a>00018 
<a name="l00019"></a>00019 <span class="comment">/*lint ++flb &quot;Enter library region&quot; */</span>
<a name="l00020"></a>00020 
<a name="l00021"></a>00021 <span class="preprocessor">#define PRODUCT_ID_BYTES 10U //!&lt; Number of bytes to expect to be in product ID</span>
<a name="l00022"></a>00022 <span class="preprocessor"></span>
<a name="l00023"></a>00023 <span class="keyword">static</span> uint8_t m_device_address; 
<a name="l00024"></a>00024 <span class="keyword">static</span> <span class="keyword">const</span> uint8_t expected_product_id[PRODUCT_ID_BYTES] = {<span class="charliteral">&#39;T&#39;</span>, <span class="charliteral">&#39;M&#39;</span>, <span class="charliteral">&#39;1&#39;</span>, <span class="charliteral">&#39;9&#39;</span>, <span class="charliteral">&#39;4&#39;</span>, <span class="charliteral">&#39;4&#39;</span>, <span class="charliteral">&#39;-&#39;</span>, <span class="charliteral">&#39;0&#39;</span>, <span class="charliteral">&#39;0&#39;</span>, <span class="charliteral">&#39;2&#39;</span>};  
<a name="l00025"></a>00025 
<a name="l00026"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga56d2b2da22fd614a12dead51b86f5be8">00026</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga56d2b2da22fd614a12dead51b86f5be8" title="Touchpad initialization.">touchpad_init</a>(uint8_t device_address)
<a name="l00027"></a>00027 {   
<a name="l00028"></a>00028   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">true</span>;
<a name="l00029"></a>00029 
<a name="l00030"></a>00030   m_device_address = (uint8_t)(device_address &lt;&lt; 1);
<a name="l00031"></a>00031 
<a name="l00032"></a>00032   <span class="comment">// Do a soft reset</span>
<a name="l00033"></a>00033   uint8_t reset_command = 0x01;
<a name="l00034"></a>00034   transfer_succeeded &amp;= <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gad33761514312c640fc14e096069476b9" title="Writes a touchpad register contents over TWI.">touchpad_write_register</a>(<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga81cf02c11ea295d8110493005dd1babd" title="Address of reset.">TOUCHPAD_RESET</a>, reset_command);
<a name="l00035"></a>00035 
<a name="l00036"></a>00036   <span class="comment">// Page select 0</span>
<a name="l00037"></a>00037   uint8_t page_to_select = 0x00;
<a name="l00038"></a>00038   transfer_succeeded &amp;= <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gad33761514312c640fc14e096069476b9" title="Writes a touchpad register contents over TWI.">touchpad_write_register</a>(<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga40ad4ab55f47fb885452b74af1d61b06" title="Address of page select (can be found in every page at the same address)">TOUCHPAD_PAGESELECT</a>, page_to_select);
<a name="l00039"></a>00039 
<a name="l00040"></a>00040   <span class="comment">// Read and verify product ID</span>
<a name="l00041"></a>00041   transfer_succeeded &amp;= <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga64efe8dc563464be3110e139729c663b" title="Reads and verifies touchpad&#39;s product ID.">touchpad_product_id_verify</a>();
<a name="l00042"></a>00042 
<a name="l00043"></a>00043   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00044"></a>00044 }
<a name="l00045"></a>00045 
<a name="l00046"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga64efe8dc563464be3110e139729c663b">00046</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga64efe8dc563464be3110e139729c663b" title="Reads and verifies touchpad&#39;s product ID.">touchpad_product_id_verify</a>(<span class="keywordtype">void</span>) 
<a name="l00047"></a>00047 {
<a name="l00048"></a>00048   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">true</span>;
<a name="l00049"></a>00049   uint8_t product_id[PRODUCT_ID_BYTES];
<a name="l00050"></a>00050   transfer_succeeded &amp;= <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga32ff3519e36304ef6111a893730a22a8" title="Writes touchpad register contents over TWI. Writes one or more consecutive registers.">touchpad_product_id_read</a>(product_id, PRODUCT_ID_BYTES);
<a name="l00051"></a>00051 
<a name="l00052"></a>00052   <span class="keywordflow">for</span> (uint8_t i = 0; i &lt; 10; i++)
<a name="l00053"></a>00053   {
<a name="l00054"></a>00054     <span class="keywordflow">if</span> (product_id[i] != expected_product_id[i])
<a name="l00055"></a>00055     {
<a name="l00056"></a>00056       transfer_succeeded = <span class="keyword">false</span>;
<a name="l00057"></a>00057     }
<a name="l00058"></a>00058   }
<a name="l00059"></a>00059 
<a name="l00060"></a>00060   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00061"></a>00061 }
<a name="l00062"></a>00062 
<a name="l00063"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gac053ca9455c2ee583def58d2d826cd9c">00063</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gac053ca9455c2ee583def58d2d826cd9c" title="Attempts to soft-reset the device.">touchpad_reset</a>(<span class="keywordtype">void</span>)
<a name="l00064"></a>00064 {
<a name="l00065"></a>00065   uint8_t w2_data[2] = {<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gaf471db4675c021cc375b84815f2c3561" title="Device command register.">TOUCHPAD_COMMAND</a>, 0x01};
<a name="l00066"></a>00066 
<a name="l00067"></a>00067   <span class="keywordflow">return</span> <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, w2_data, 2, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00068"></a>00068 }
<a name="l00069"></a>00069 
<a name="l00070"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga22b2f1fbcc1c09d3fcb5dae98e7a7dd2">00070</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga22b2f1fbcc1c09d3fcb5dae98e7a7dd2" title="Reads the interrupt status register of the device. This clears all interrupts.">touchpad_interrupt_status_read</a>(uint8_t *interrupt_status) 
<a name="l00071"></a>00071 {
<a name="l00072"></a>00072   <span class="keywordflow">return</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga517f43a4e4520713f69f14b38efc927b" title="Function to read a touchpad register contents over TWI.">touchpad_read_register</a>(<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga45323ee0dff39f598de4e6913ce06ef8" title="Interrupt status register.">TOUCHPAD_INT_STATUS</a>, interrupt_status);
<a name="l00073"></a>00073 }
<a name="l00074"></a>00074 
<a name="l00075"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gaeaf145b444000da6d332bf4f0333380c">00075</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gaeaf145b444000da6d332bf4f0333380c" title="Sleep mode configuration.">touchpad_set_sleep_mode</a>(<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga330fdbd5e3557a42f4c73c445d0f7337">TouchpadSleepMode_t</a> mode)
<a name="l00076"></a>00076 {
<a name="l00077"></a>00077   <span class="keywordflow">return</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gad33761514312c640fc14e096069476b9" title="Writes a touchpad register contents over TWI.">touchpad_write_register</a>(<a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gaf5a2290d3919707171195ce78d02c091" title="Device control register.">TOUCHPAD_CONTROL</a>, (uint8_t)mode);
<a name="l00078"></a>00078 }
<a name="l00079"></a>00079 
<a name="l00080"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga517f43a4e4520713f69f14b38efc927b">00080</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga517f43a4e4520713f69f14b38efc927b" title="Function to read a touchpad register contents over TWI.">touchpad_read_register</a>(uint8_t register_address, uint8_t *value)
<a name="l00081"></a>00081 {
<a name="l00082"></a>00082   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">true</span>;
<a name="l00083"></a>00083   transfer_succeeded &amp;= <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, &amp;register_address, 1, <a class="code" href="group__lib__driver__twi__master.html#gaedaa985feb5cea808d8811bd7ceeb318" title="Parameter for twi_master_transfer.">TWI_DONT_ISSUE_STOP</a>);
<a name="l00084"></a>00084   <span class="keywordflow">if</span> (transfer_succeeded) 
<a name="l00085"></a>00085   {
<a name="l00086"></a>00086     transfer_succeeded &amp;= <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address | <a class="code" href="group__lib__driver__twi__master.html#ga67c0f91739433360f513b097acf11946" title="If this bit is set in the address field, transfer direction is from slave to master.">TWI_READ_BIT</a>, value, 1, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00087"></a>00087   }
<a name="l00088"></a>00088   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00089"></a>00089 }  
<a name="l00090"></a>00090 
<a name="l00091"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gad33761514312c640fc14e096069476b9">00091</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#gad33761514312c640fc14e096069476b9" title="Writes a touchpad register contents over TWI.">touchpad_write_register</a>(uint8_t register_address, <span class="keyword">const</span> uint8_t value)
<a name="l00092"></a>00092 {
<a name="l00093"></a>00093     uint8_t w2_data[2];
<a name="l00094"></a>00094     
<a name="l00095"></a>00095     w2_data[0] = register_address;
<a name="l00096"></a>00096     w2_data[1] = value;
<a name="l00097"></a>00097   <span class="keywordflow">return</span> <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, w2_data, 2, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00098"></a>00098 }
<a name="l00099"></a>00099 
<a name="l00100"></a><a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga32ff3519e36304ef6111a893730a22a8">00100</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga32ff3519e36304ef6111a893730a22a8" title="Writes touchpad register contents over TWI. Writes one or more consecutive registers.">touchpad_product_id_read</a>(uint8_t *product_id, uint8_t product_id_bytes)
<a name="l00101"></a>00101 {
<a name="l00102"></a>00102     uint8_t w2_data[1];
<a name="l00103"></a>00103   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">true</span>;
<a name="l00104"></a>00104     
<a name="l00105"></a>00105     w2_data[0] = <a class="code" href="group__nrf__drivers__synaptics__touchpad.html#ga2fc2cf0bedd74903e7181acfe0df6941" title="Address of product ID string.">TOUCHPAD_PRODUCT_ID</a>;
<a name="l00106"></a>00106   transfer_succeeded &amp;= <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, w2_data, 1, <a class="code" href="group__lib__driver__twi__master.html#gaedaa985feb5cea808d8811bd7ceeb318" title="Parameter for twi_master_transfer.">TWI_DONT_ISSUE_STOP</a>);
<a name="l00107"></a>00107   <span class="keywordflow">if</span> (transfer_succeeded) 
<a name="l00108"></a>00108   {
<a name="l00109"></a>00109     transfer_succeeded &amp;= <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address | <a class="code" href="group__lib__driver__twi__master.html#ga67c0f91739433360f513b097acf11946" title="If this bit is set in the address field, transfer direction is from slave to master.">TWI_READ_BIT</a>, product_id, product_id_bytes, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00110"></a>00110   }
<a name="l00111"></a>00111   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00112"></a>00112 }
<a name="l00113"></a>00113 
<a name="l00114"></a>00114 <span class="comment">/*lint --flb &quot;Leave library region&quot; */</span> 
</pre></div></div>
</div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><b>synaptics_touchpad.c</b>      </li>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Defines</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>


    <li class="footer">
      Copyright &copy 2006-2011 <a href="http://www.nordicsemi.no" style="text-decoration:none">Nordic Semiconductor</a>.
      All Rights Reserved.
      <a href="disclaimer.html">Disclaimer</a>
    </li>
   </ul>
 </div>


</body>
</html>
